home *** CD-ROM | disk | FTP | other *** search
/ IBM InfoROM for OS/2 Beta 1995 January / IBM InfoROM for OS2 Beta 1-1995.ISO / testcert / storage / function / cdrom / cdrom.gra < prev    next >
Encoding:
Text File  |  1994-08-05  |  29.6 KB  |  662 lines

  1. ******************************************************************************
  2. **                      CDROM.GRA DESCRIPTION FILE                          **
  3. ******************************************************************************
  4. **                         CDROM FUNCTION CALLS                             **
  5. ******************************************************************************
  6. @IMPORT GLOBAL.GRA
  7. ******************************************************************************
  8. ******************************************************************************
  9. **
  10. ** CD-ROM OPEN
  11. **
  12. ** THIS FUNCTION OPENS THE CDROM.
  13. **
  14. **   REQUIRED INPUT PARAMETERS : DEVICENAME   : DRIVE LETTER OF CDROM
  15. **
  16. **   OUTPUT PARAMTERS          : $DRIVES      : NUMBER OF CD-ROM DRIVES IN
  17. **                                            :   THE SYSTEM UNDER TEST
  18. **                             : $FIRSTCD     : DRIVE NUMBER FOR CD-ROM
  19. **                                            :   DRIVE IN THE SYSTEM, 
  20. **                                            :   WHERE:
  21. **                                            :     00=DRIVE A
  22. **                                            :     01=DRIVE B
  23. **                                            :     02=DRIVE C, ETC.
  24. **                                         
  25. **   LOGGED DATA               : NONE
  26. **
  27. CDROM_OPEN                      $DLL=DDTCDROM \
  28.                                 DEVICENAME=STRING \
  29.                                 $FUNC=@cdrom_devopen$qr8Kwd_List 
  30.  
  31. ******************************************************************************
  32. ******************************************************************************
  33. **
  34. ** CD-ROM CLOSE
  35. **
  36. ** THIS FUNCTION CLOSES THE CDROM.
  37. **
  38. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  39. **
  40. **   OUTPUT PARAMTERS          : NONE
  41. **                              
  42. **   LOGGED DATA               : NONE
  43. **
  44. CDROM_CLOSE                     $DLL=DDTCDROM \
  45.                                 DRIVEHANDLE=NUM \
  46.                                 $FUNC=@cdrom_devclose$qr8Kwd_List 
  47.  
  48. ******************************************************************************
  49. ******************************************************************************
  50. **
  51. ** Cat 82H Function 60H - RETURN DRIVE-LETTER INFORMATION
  52. **
  53. ** THIS FUNCTION QUERYS THE CDROM DRIVE LETTER FROM THE SYSTEM.
  54. **
  55. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  56. **
  57. **   OUTPUT PARAMTERS          : $DRIVES      : NUMBER OF CD-ROM DRIVES IN
  58. **                                            :   THE SYSTEM UNDER TEST
  59. **                             : $FIRSTCD     : DRIVE NUMBER FOR CD-ROM
  60. **                                            :   DRIVE IN THE SYSTEM, 
  61. **                                            :   WHERE:
  62. **                                            :     00=DRIVE A
  63. **                                            :     01=DRIVE B
  64. **                                            :     02=DRIVE C, ETC.
  65. **                              
  66. **   LOGGED DATA               : NONE
  67. **
  68. CDROM_QUERYDRIVELETTER          $DLL=DDTCDROM \
  69.                                 $FUNC=@cdrom_qdriveletter$qr8Kwd_List 
  70.  
  71. ******************************************************************************
  72. ******************************************************************************
  73. **
  74. ** Cat 80H Function 44H - EJECT DISC
  75. **
  76. ** THIS FUNCTION EJECTS THE CDROM DISC FROM THE CDROM DRIVE.
  77. **
  78. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  79. **
  80. **   OUTPUT PARAMTERS          : NONE
  81. **                              
  82. **   LOGGED DATA               : NONE
  83. **
  84. CDROM_EJECT                     $DLL=DDTCDROM \
  85.                                 DRIVEHANDLE=NUM \
  86.                                 $FUNC=@cdrom_eject$qr8Kwd_List 
  87.  
  88. ******************************************************************************
  89. ******************************************************************************
  90. **
  91. ** Cat 80H Function 46H - LOCK DOOR
  92. **
  93. ** THIS FUNCTION LOCKS THE CDROM DRIVE DOOR.
  94. **
  95. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  96. **
  97. **   OUTPUT PARAMTERS          : NONE
  98. **                              
  99. **   LOGGED DATA               : NONE
  100. **
  101. CDROM_LOCKDOOR                  $DLL=DDTCDROM \
  102.                                 DRIVEHANDLE=NUM \
  103.                                 $FUNC=@cdrom_lockdoor$qr8Kwd_List
  104.  
  105. ******************************************************************************
  106. ******************************************************************************
  107. **
  108. ** Cat 80H Function 46H - UNLOCK DOOR
  109. **
  110. ** THIS FUNCTION UNLOCKS THE CDROM DRIVE DOOR.
  111. **
  112. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  113. **
  114. **   OUTPUT PARAMTERS          : NONE
  115. **                              
  116. **   LOGGED DATA               : NONE
  117. **
  118. CDROM_UNLOCKDOOR                $DLL=DDTCDROM \
  119.                                 DRIVEHANDLE=NUM \
  120.                                 $FUNC=@cdrom_unlockdoor$qr8Kwd_List 
  121.  
  122. ******************************************************************************
  123. ******************************************************************************
  124. **
  125. ** Cat 81H Function 61H - RETURN AUDIO-DISC INFORMATION
  126. **
  127. ** THIS FUNCTION RETURNS THE FIRST AND LAST TRACK NUMBERS AND THE REDBOOK 
  128. ** ADDRESS FOR LEADING TRACK.
  129. **
  130. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  131. **
  132. **   OUTPUT PARAMTERS          : HIGHTRACK    : HIGHEST TRACK NUMBER
  133. **                             : LOWTRACK     : LOWEST TRACK NUMBER
  134. **                              
  135. **   LOGGED DATA               : LOWTRACK     : LOWEST TRACK NUMBER 
  136. **                             : HIGHTRACK    : HIGHEST TRACK NUMBER
  137. **                             : ADDRESS      : STARTING POINT OF LEAD-OUT TRACK
  138. **
  139. CDROM_QUERYAUDIODISKINFO        $DLL=DDTCDROM \
  140.                                 DRIVEHANDLE=NUM \
  141.                                 $FUNC=@cdrom_qaudiodiskinfo$qr8Kwd_List 
  142.  
  143. ******************************************************************************
  144. ******************************************************************************
  145. **
  146. ** Cat 81H Function 65H - AUDIO-STATUS INFORMATION
  147. **
  148. ** THIS FUNCTION RETURNS THE AUDIO STATUS, AND THE STARTING AND ENDING
  149. ** LOCATIONS OF THE LAST PLAYBACK.
  150. **
  151. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  152. **
  153. **   OUTPUT PARAMTERS          : NONE
  154. **                              
  155. **   LOGGED DATA               : WORD         : AUDIO STATUS BITS 
  156. **                             : DWORD        : STARTING LOCATION OF LAST PLAY
  157. **                                            :   AUDIO OR RESUME AUDIO COMMAND 
  158. **                             : DWORD        : ENDING LOCATION OF LAST PLAY 
  159. **                                            :   AUDIO OR RESUME AUDIO COMMAND 
  160. **
  161. CDROM_QUERYAUDIOSTATUS          $DLL=DDTCDROM \
  162.                                 DRIVEHANDLE=NUM \
  163.                                 $FUNC=@cdrom_queryaudiostatus$qr8Kwd_List 
  164.  
  165. ******************************************************************************
  166. ******************************************************************************
  167. **
  168. ** Cat 80H Function 61H - IDENTIFY CD-ROM DRIVER
  169. **
  170. ** THIS FUNCTION IDENTIFIES THE DEVICE DRIVER AS A VALID CDROM DRIVER.
  171. **
  172. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  173. **
  174. **   OUTPUT PARAMTERS          : NONE
  175. **                              
  176. **   LOGGED DATA               : CDROM DRIVER : CDROM DEVICE DRIVER ID
  177. **
  178. CDROM_QUERYDRIVERINFO           $DLL=DDTCDROM \
  179.                                 DRIVEHANDLE=NUM \
  180.                                 $FUNC=@cdrom_qdriverinfo$qr8Kwd_List 
  181.  
  182. ******************************************************************************
  183. ******************************************************************************
  184. **
  185. ** Cat 80H Function 63H - RETURN SECTOR SIZE
  186. **
  187. ** THIS FUNCTION RETURNS THE NUMBER OF BYTES PER SECTOR THAT THE DEVICE DRIVER
  188. ** SUPPORTS.
  189. **
  190. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  191. **
  192. **   OUTPUT PARAMTERS          : NONE
  193. **                              
  194. **   LOGGED DATA               : SECTOR SIZE  : SIZE OF SECTORS ON DISC
  195. **
  196. CDROM_QUERYSECTORINFO           $DLL=DDTCDROM \
  197.                                 DRIVEHANDLE=NUM \
  198.                                 $FUNC=@cdrom_qsectorinfo$qr8Kwd_List 
  199.  
  200. ******************************************************************************
  201. ******************************************************************************
  202. **
  203. ** Cat 80H Function 78H - RETURN VOLUME SIZE
  204. **
  205. ** THIS FUNCTION RETURNS THE TOTAL NUMBER OF ACCESSIBLE SECTORS ON THE DISK.
  206. **
  207. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  208. **
  209. **   OUTPUT PARAMTERS          : NONE
  210. **                              
  211. **   LOGGED DATA               : VOLUME SIZE  : VOLUME SIZE IN SECTORS
  212. **
  213. CDROM_QUERYVOLUMESIZE           $DLL=DDTCDROM \
  214.                                 DRIVEHANDLE=NUM \
  215.                                 $FUNC=@cdrom_qvolsize$qr8Kwd_List 
  216.  
  217. ******************************************************************************
  218. ******************************************************************************
  219. **
  220. ** Cat 81H Function 62H - RETURN AUDIO-TRACK INFORMATION
  221. **
  222. ** THIS FUNCTION RETURNS THE REDBOOK ADDRESS FOR THE STARTING POINT AND  
  223. ** TRACK-CONTROL INFORMATION FOR A SPECIFIED TRACK.
  224. **
  225. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  226. **                             : TRACK        : TRACK NUMBER       
  227. **
  228. **   OUTPUT PARAMTERS          : NONE
  229. **                              
  230. **   LOGGED DATA               : ADDRESS      : STARTING POINT OF TRACK
  231. **                             : TRACK INFO   : TRACK-CONTROL INFORMATION    
  232. **
  233. CDROM_QUERYAUDIOTRACKINFO       $DLL=DDTCDROM \
  234.                                 DRIVEHANDLE=NUM \
  235.                                 TRACK=NUM \
  236.                                 $FUNC=@cdrom_qaudiotrack$qr8Kwd_List 
  237.  
  238. ******************************************************************************
  239. ******************************************************************************
  240. **
  241. ** Cat 80H Function 60H - DEVICE STATUS
  242. **
  243. ** THIS FUNCTION RETURNS THE DEVICE DRIVER STATUS CODES.
  244. **
  245. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  246. **
  247. **   OUTPUT PARAMTERS          : NONE
  248. **                              
  249. **   LOGGED DATA               : DRIVE STATUS : CD-ROM DRIVE STATUS INFORMATION
  250. **
  251. CDROM_QUERYSTATUS               $DLL=DDTCDROM \
  252.                                 DRIVEHANDLE=NUM \
  253.                                 $FUNC=@cdrom_querystatus$qr8Kwd_List 
  254.  
  255. ******************************************************************************
  256. ******************************************************************************
  257. **
  258. ** Cat 80H Function 79H - GET UPC
  259. **
  260. ** THIS FUNCTION RETURNS THE UPC CODE FOR THE CDROM DISK. 
  261. **
  262. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  263. **
  264. **   OUTPUT PARAMTERS          : NONE
  265. **                              
  266. **   LOGGED DATA               : CONTROL BYTE : CONTROL AND ADR BYTE
  267. **                             : UPCC CODE    : UNIVERSAL PRODUCT CODE
  268. **                             : FRAME        : FRAME
  269. **
  270. CDROM_QUERYUPCC                 $DLL=DDTCDROM \
  271.                                 DRIVEHANDLE=NUM \
  272.                                 $FUNC=@cdrom_queryupccode$qr8Kwd_List 
  273.  
  274. ******************************************************************************
  275. ******************************************************************************
  276. **
  277. ** Cat 81H Function 63H - RETURN AUDIO-SUBCHANNEL Q INFORMATION
  278. **
  279. ** THIS FUNCTION RETURNS TRACK AND CONTROL INFORMATION WHILE THE DRIVE
  280. ** IS PLAYING A AUDIO CDROM DISK. 
  281. **
  282. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  283. **
  284. **   OUTPUT PARAMTERS          : NONE
  285. **                              
  286. **   LOGGED DATA               : CONTROL      : CONTROL AND ADR BYTE
  287. **                             : TRACK        : TRACK NUMBER
  288. **                             : INDEX        : INDEX
  289. **                             : ELAPSED MIN. : RUNNING TIME WITHIN A 
  290. **                                            :   TRACK, MINUTES
  291. **                             : ELAPSED SEC. : RUNNING TIME WITHIN A 
  292. **                                            :   TRACK, SECONDS
  293. **                             : ELAPSED FRAME: RUNNING TIME WITHIN A
  294. **                                            :   TRACK, FRAMES
  295. **                             : ELAPSED MIN. : RUNNING TIME WITHIN A 
  296. **                                            :   DISK, MINUTES
  297. **                             : ELAPSED SEC. : RUNNING TIME WITHIN A
  298. **                                            :   DISK, SECONDS
  299. **                             : ELAPSED FRMAE: RUNNING TIME WITHIN A
  300. **                                            :   DISK, FRAMES
  301. **
  302. CDROM_QUERYCHANINFO             $DLL=DDTCDROM \
  303.                                 DRIVEHANDLE=NUM \
  304.                                 $FUNC=@cdrom_querychaninfo$qr8Kwd_List 
  305.  
  306. ******************************************************************************
  307. ******************************************************************************
  308. **
  309. ** Cat 81H Function 40H - AUDIO CHANNEL CONTROL
  310. **
  311. ** THIS FUNCTION RETURNS THE CURRENT SETTINGS OF THE AUDIO CHANNEL CONTROLS.
  312. **
  313. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  314. **
  315. **   OUTPUT PARAMTERS          : NONE
  316. **                              
  317. **   LOGGED DATA               : BYTE         : INPUT CHANNEL FOR OUTPUT
  318. **                                            :   CHANNEL 0
  319. **                             : BYTE         : VOLUME CONTROL FOR OUTPUT
  320. **                                            :   CHANNEL 0
  321. **                             : BYTE         : INPUT CHANNEL FOR OUTPUT
  322. **                                            :   CHANNEL 1
  323. **                             : BYTE         : VOLUME CONTROL FOR OUTPUT
  324. **                                            :   CHANNEL 1
  325. **                             : BYTE         : INPUT CHANNEL FOR OUTPUT
  326. **                                            :   CHANNEL 2
  327. **                             : BYTE         : VOLUME CONTROL FOR OUTPUT
  328. **                                            :   CHANNEL 2 
  329. **                             : BYTE         : INPUT CHANNEL FOR OUTPUT
  330. **                                            :    CHANNEL 3
  331. **                             : BYTE         : VOLUME CONTROL FOR OUTPUT
  332. **                                            :    CHANNEL 3
  333. **
  334. CDROM_QUERYAUDIOCHANINFO        $DLL=DDTCDROM \
  335.                                 DRIVEHANDLE=NUM \
  336.                                 $FUNC=@cdrom_qaudiochaninfo$qr8Kwd_List 
  337.  
  338. ******************************************************************************
  339. ******************************************************************************
  340. **
  341. ** THIS FUNCTION SETS THE CURRENT SETTINGS OF THE AUDIO CHANNEL CONTROLS.
  342. **
  343. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  344. **                             : VOL1         : VOLUME FOR CHANNEL 0
  345. **                             : VOL2         : VOLUME FOR CHANNEL 1
  346. **                             : VOL3         : VOLUME FOR CHANNEL 2
  347. **                             : VOL4         : VOLUME FOR CHANNEL 3
  348. **
  349. **                EXAMPLE:       VOL1 = (0-255)
  350. **                               VOL2 = (0-255)
  351. **                               VOL3 = (0-255)
  352. **                               VOL4 = (0-255)
  353. **
  354. **   OUTPUT PARAMTERS          : NONE
  355. **                              
  356. **   LOGGED DATA               : NONE
  357. **
  358. CDROM_AUDIOCHANINFO             $DLL=DDTCDROM \
  359.                                 DRIVEHANDLE=NUM \
  360.                                 VOL1=NUM  \
  361.                                 VOL2=NUM  \
  362.                                 VOL3=NUM  \
  363.                                 VOL4=NUM  \
  364.                                 $FUNC=@cdrom_audiochaninfo$qr8Kwd_List
  365.  
  366. ******************************************************************************
  367. ******************************************************************************
  368. **
  369. ** Cat 80H Function 40H - RESET DRIVE 
  370. **
  371. ** THIS FUNCTION RESETS AND REINITIALIZES THE DRIVE AND CONTROLLER.
  372. **
  373. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  374. **
  375. **   OUTPUT PARAMTERS          : NONE
  376. **                              
  377. **   LOGGED DATA               : NONE
  378. **
  379. CDROM_RESET                     $DLL=DDTCDROM \
  380.                                 DRIVEHANDLE=NUM \
  381.                                 $FUNC=@cdrom_reset$qr8Kwd_List 
  382.  
  383. ******************************************************************************
  384. ******************************************************************************
  385. **
  386. ** Cat 81H Function 51H - STOP AUDIO
  387. **
  388. ** THIS FUNCTION CANCELS ANY ACTIVE PLAY REQUEST.
  389. **
  390. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  391. **
  392. **   OUTPUT PARAMTERS          : NONE
  393. **                              
  394. **   LOGGED DATA               : NONE
  395. **
  396. CDROM_STOPAUDIO                 $DLL=DDTCDROM \
  397.                                 DRIVEHANDLE=NUM \
  398.                                 $FUNC=@cdrom_stopaudio$qr8Kwd_List 
  399.  
  400. ******************************************************************************
  401. ******************************************************************************
  402. **
  403. ** Cat 81H Function 52H - RESUME AUDIO
  404. **
  405. ** THIS FUNCTION RESUMES PLAYING AUDIO AFTER PLAY HAS BEEN INTERRUPTED
  406. ** BY THE STOP AUDIO COMMAND.
  407. **
  408. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  409. **
  410. **   OUTPUT PARAMTERS          : NONE
  411. **                              
  412. **   LOGGED DATA               : NONE
  413. **
  414. CDROM_RESUMEAUDIO               $DLL=DDTCDROM \
  415.                                 DRIVEHANDLE=NUM \
  416.                                 $FUNC=@cdrom_resumeaudio$qr8Kwd_List 
  417.  
  418. ******************************************************************************
  419. ******************************************************************************
  420. **
  421. ** Cat 81H Function 50H - PLAY AUDIO
  422. **
  423. ** THIS FUNCTION PLAYS A SELECTED AUDIO TRACK. THE FUNCTION CAN PLAY AUDIO
  424. ** BY BEING PASSED EITHER A SECTOR START VALUE OR A TIME START VALUE.
  425. **
  426. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  427. **                             : ADDRESSMODE  : ADDRESSING MODE -- EITHER
  428. **                                     1) LOGICAL BLOCK
  429. **                                     2) REDBOOK - MINUTES/SECONDS/FRAMES                                   
  430. **                             : SECTORSTART --- IF USING LOGICAL BLOCK
  431. **                             : SECTORCOUNT --- IF USING LOGICAL BLOCK
  432. **                             : TIMESTART   --- IF USING REDBOOK
  433. **                             : TIMESTOP    --- IF USING REDBOOK
  434. **
  435. **               EXAMPLES:       REDBOOK 
  436. **                                       : ADDRESSMODE=REDBOOK
  437. **                                       : TIMESTART=02:45:00
  438. **                                       : TIMESTOP=05:55:00
  439. **
  440. **                               LOGICALBLOCK 
  441. **                                       : ADDRESSMODE=LOGICALBLOCK
  442. **                                       : SECTORSTART=20000
  443. **                                       : SECTORCOUNT=10000      
  444. **
  445. **   OUTPUT PARAMTERS          : NONE
  446. **                              
  447. **   LOGGED DATA               : NONE
  448. **
  449. CDROM_PLAYAUDIO                 $DLL=DDTCDROM \
  450.                                 DRIVEHANDLE=NUM \
  451.                                 ADDRESSMODE=STRING \
  452.                                 $FUNC=@cdrom_playaudio$qr8Kwd_List 
  453.  
  454. ******************************************************************************
  455. ******************************************************************************
  456. **
  457. ** Cat 80H Function 50H - SEEK
  458. **
  459. ** THIS FUNCTION MOVES THE READ HEAD TO A SPECIFIED BLOCK THAT IS PASSED TO
  460. ** TO THE FUNCTION. THE FUNCTION CAN SEEK A SPECIFIED BLOCK BY EITHER
  461. ** HAVING THE SECTOR START VALUE OR A TIME START VALUE.
  462. **
  463. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  464. **                             : ADDRESSMODE  : ADDRESSING MODE -- EITHER
  465. **                                     1) LOGICAL BLOCK
  466. **                                     2) REDBOOK - MINUTES/SECONDS/FRAMES                                   
  467. **                             : SECTORSTART --- IF USING LOGICAL BLOCK
  468. **                             : SECTORCOUNT --- IF USING LOGICAL BLOCK
  469. **                             : TIMESTART   --- IF USING REDBOOK
  470. **                             : TIMESTOP    --- IF USING REDBOOK
  471. **
  472. **               EXAMPLES:       REDBOOK 
  473. **                                       : ADDRESSMODE=REDBOOK
  474. **                                       : TIMESTART=02:45:00
  475. **                                       : TIMESTOP=05:55:00
  476. **
  477. **                               LOGICALBLOCK 
  478. **                                       : ADDRESSMODE=LOGICALBLOCK
  479. **                                       : SECTORSTART=20000
  480. **                                       : SECTORCOUNT=10000      
  481. **
  482. **
  483. **   OUTPUT PARAMTERS          : NONE
  484. **                              
  485. **   LOGGED DATA               : NONE
  486. **
  487. CDROM_SEEK                      $DLL=DDTCDROM \
  488.                                 DRIVEHANDLE=NUM \
  489.                                 ADDRESSMODE=STRING \
  490.                                 $FUNC=@cdrom_seek$qr8Kwd_List 
  491.  
  492. ******************************************************************************
  493. ******************************************************************************
  494. **
  495. ** Cat 80H Function 70H - LOCATION OF DRIVE HEAD
  496. **
  497. ** THIS FUNCTION RETURNS THE CURRENT DRIVE-HEAD LOCATION. THIS FUNCTION WILL
  498. ** RETURN THE VALUE IN EITHER ADDRESSING MODE. 
  499. **
  500. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  501. **                             : ADDRESSMODE  : ADDRESSING MODE -- EITHER
  502. **                                     1) LOGICAL BLOCK
  503. **                                     2) REDBOOK
  504. **
  505. **               EXAMPLE:        REDBOOK 
  506. **                                       : ADDRESSMODE=REDBOOK
  507. **
  508. **                               LOGICALBLOCK 
  509. **                                       : ADDRESSMODE=LOGICALBLOCK
  510. **
  511. **   OUTPUT PARAMTERS          : NONE
  512. **                              
  513. **   LOGGED DATA               : DRIVE HEAD   : LOCATION OF DRIVE HEAD 
  514. **
  515. CDROM_DRIVELOCATION             $DLL=DDTCDROM \
  516.                                 DRIVEHANDLE=NUM \
  517.                                 ADDRESSMODE=STRING \
  518.                                 $FUNC=@cdrom_drivelocation$qr8Kwd_List
  519.  
  520. ******************************************************************************
  521. ******************************************************************************
  522. **
  523. ** DOS READ FILE
  524. **
  525. ** THIS FUNCTION READS A SELECTED FILE FROM A CDROM DISK. IT READS IN THE 
  526. ** THE NUMBER OF BYTES THAT ARE PASSED TO THE FUNCTION.
  527. **
  528. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  529. **                             : FILENAME     : NAME OF FILE TO READ
  530. **                             : ADDRESSMODE  : ADDRESSING MODE 
  531. **                                      LOGICAL BLOCK
  532. **                             : BYTESTART    : STARTING BYTE TO READ
  533. **                             : BYTECOUNT    : NUMBER OF BYTES TO READ
  534. **
  535. **               EXAMPLE:        LOGICALBLOCK 
  536. **                                       : ADDRESSMODE=LOGICALBLOCK
  537. **                                       : BYTESTART=2000
  538. **                                       : BYTECOUNT=30000
  539. **                                       : FILENAME=E:\\README.TXT
  540. **
  541. **   OUTPUT PARAMTERS          : NONE
  542. **                              
  543. **   LOGGED DATA               : BYTE(S) : BYTE(S) READ 
  544. **
  545. CDROM_READFILE                  $DLL=DDTCDROM \
  546.                                 DRIVEHANDLE=NUM \
  547.                                 ADDRESSMODE=STRING \
  548.                                 BYTESTART=NUM \
  549.                                 BYTECOUNT=NUM \
  550.                                 $FUNC=@cdrom_devreadfile$qr8Kwd_List 
  551.  
  552. ******************************************************************************
  553. ******************************************************************************
  554. **
  555. ** DOS READ
  556. **
  557. ** THIS FUNCTION READS A SELECTED FILE FROM A CDROM DISK. IT READS IN A GROUP
  558. ** OF SECTORS AT ONE TIME. EACH SECTOR CONTAINS 2048 BYTES. THE NUMBER OF
  559. ** SECTORS TO READ NEED TO BE PASSED TO THE FUNCTION.
  560. **
  561. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  562. **                             : ADDRESSMODE  : ADDRESSING MODE 
  563. **                                       LOGICAL BLOCK
  564. **                             : SECTORSTART --- STARTING SECTOR TO READ
  565. **                             : SECTORCOUNT --- NUMBER OF SECTORS TO READ
  566. **
  567. **               EXAMPLE:        LOGICALBLOCK 
  568. **                                       : ADDRESSMODE=LOGICALBLOCK
  569. **                                       : SECTORSTART=20000
  570. **                                       : SECTORCOUNT=10000      
  571. **
  572. **   OUTPUT PARAMTERS          : NONE
  573. **                              
  574. **   LOGGED DATA               : 12 BYTES     : BYTE SYNC
  575. **                             : 4 BYTES      : BYTE HEADER
  576. **                             : 2048 BYTES   : BYTE DATA AREA
  577. **                             : 288 BYTES    : BYTE EDC/ECC AREA
  578. **
  579. CDROM_READ2048                  $DLL=DDTCDROM \
  580.                                 DRIVEHANDLE=NUM \
  581.                                 ADDRESSMODE=STRING \
  582.                                 SECTORSTART=NUM \
  583.                                 SECTORCOUNT=NUM \
  584.                                 $FUNC=@cdrom_devread2048$qr8Kwd_List
  585.  
  586. ******************************************************************************
  587. ******************************************************************************
  588. **
  589. ** Cat 80H Function 72H - READ LONG
  590. **
  591. ** THIS FUNCTION READS A SELECTED FILE FROM A CDROM DISK. IT READS IN A GROUP
  592. ** OF SECTORS AT ONE TIME. THIS FUNCTION READS 2352 BYTES FROM EACH SECTOR.
  593. ** THIS FUNCTION IS THE SAME AS READ2048, EXCEPT THIS FUNCTION ALSO READS IN 
  594. ** ALL OF THE SECTOR HEADER INFORMATION AS WELL. THE NUMBER OF SECTORS TO
  595. ** READ NEED TO BE PASSED TO THE FUNCTION.
  596. **
  597. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  598. **                             : ADDRESSMODE  : ADDRESSING MODE 
  599. **                                       LOGICAL BLOCK
  600. **                             : SECTORSTART --- STARTING SECTOR TO READ
  601. **                             : SECTORCOUNT --- NUMBER OF SECTORS TO READ
  602. **
  603. **               EXAMPLE:        LOGICALBLOCK 
  604. **                                       : ADDRESSMODE=LOGICALBLOCK
  605. **                                       : SECTORSTART=20000
  606. **                                       : SECTORCOUNT=10000      
  607. **
  608. **   OUTPUT PARAMTERS          : NONE
  609. **                              
  610. **   LOGGED DATA               : 12 BYTES     : BYTE SYNC
  611. **                             : 4 BYTES      : BYTE HEADER
  612. **                             : 2048 BYTES   : BYTE DATA AREA
  613. **                             : 288 BYTES    : BYTE EDC/ECC AREA
  614. **
  615. CDROM_READ2352                  $DLL=DDTCDROM \
  616.                                 DRIVEHANDLE=NUM \
  617.                                 ADDRESSMODE=STRING \
  618.                                 SECTORSTART=NUM \
  619.                                 SECTORCOUNT=NUM \
  620.                                 $FUNC=@cdrom_read2352$qr8Kwd_List 
  621.  
  622. ******************************************************************************
  623. ******************************************************************************
  624. **
  625. ** Cat 81H Function 71H - READ LONG PREFETCH
  626. **
  627. ** THIS FUNCTION READS A SELECTED FILE FROM A CDROM DISK. IT READS IN A GROUP
  628. ** OF SECTORS AT ONE TIME. THIS FUNCTION READS 2352 BYTES FROM EACH SECTOR.
  629. ** THIS FUNCTION IS THE SAME AS READ2352, EXCEPT THIS FUNCTION PREFETCHES 
  630. ** THE SECTOR INFORMATION. THIS WILL READ IN THE SECTOR INFORMATION IN 
  631. ** ANTICIPATION OF A SYSTEM REQUEST FOR THE SECTOR INFORMATION. THE NUMBER
  632. ** OF SECTORS TO READ NEED TO BE PASSED TO THE FUNCTION.
  633. **
  634. **   REQUIRED INPUT PARAMETERS : DRIVEHANDLE  : DRIVE HANDLE FOR CDROM DRIVE
  635. **                             : ADDRESSMODE  : ADDRESSING MODE 
  636. **                                       LOGICAL BLOCK
  637. **                             : SECTORSTART --- STARTING SECTOR TO READ
  638. **                             : SECTORCOUNT --- NUMBER OF SECTORS TO READ
  639. **
  640. **               EXAMPLE:        LOGICALBLOCK 
  641. **                                       : ADDRESSMODE=LOGICALBLOCK
  642. **                                       : SECTORSTART=20000
  643. **                                       : SECTORCOUNT=10000      
  644. **
  645. **   OUTPUT PARAMTERS          : NONE
  646. **                              
  647. **   LOGGED DATA               : 12 BYTES     : BYTE SYNC
  648. **                             : 4 BYTES      : BYTE HEADER
  649. **                             : 2048 BYTES   : BYTE DATA AREA
  650. **                             : 288 BYTES    : BYTE EDC/ECC AREA
  651. **
  652. CDROM_READPRE2352               $DLL=DDTCDROM \
  653.                                 DRIVEHANDLE=NUM \
  654.                                 ADDRESSMODE=STRING \
  655.                                 SECTORSTART=NUM \
  656.                                 SECTORCOUNT=NUM \
  657.                                 $FUNC=@cdrom_readpre2352$qr8Kwd_List 
  658.  
  659. ******************************************************************************
  660. ******************************************************************************
  661.                                  
  662.